home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / sfxlib.exe / SFXLIB.DOC < prev    next >
Text File  |  1992-03-23  |  7KB  |  245 lines
  1.  
  2.  
  3.   ╒════════════════════════════════════════════════════════════╕
  4.   │                                   │
  5.   │            THE SOUND EFFECTS LIBRARY               │
  6.   │                                   │
  7.   │            from david smith               │
  8.   │               and  bill cravener               │
  9.   │             Copyright 1992                │
  10.   │                                   │
  11.   ╘════════════════════════════════════════════════════════════╛
  12.  
  13.  
  14.  
  15.  
  16.     I invented the Sound Effects Library in March of 1992 as an
  17.     attempt to enhance the programming capabilities of those
  18.     out there who are hacking in Turbo C. It is fully compatible
  19.     with all versions of TC, and can make an otherwise boring
  20.     program exciting.  I would release this as Shareware, but
  21.     we are supposedly in a recession, so save your money.  This
  22.     utility is FREEWARE.  You may use it however you'd like, and
  23.     share it with your programming friends.
  24.  
  25.  
  26.  
  27. ====== BEGINNING LIBRARY USAGE ============================================
  28.  
  29.    (Skip this if you are an experienced programmer)
  30.  
  31.    For those of you who have not used libraries before, I am going
  32.    to make it REAL simple.
  33.  
  34.    In the "include" section at the top of your C files,
  35.    add: #INCLUDE <DAVE&BIL.H> then copy that .H file into
  36.    your \tc\include directory.
  37.  
  38.    Or try #INCLUDE "DAVE&BIL.H" and keep that .H file in the
  39.    current directory.
  40.  
  41.    Next, write a program with a Sound Effect in it.  For example:
  42.  
  43.    TEST.C
  44.  
  45.    source code for TEST.C:
  46.  
  47.  ┌──────────────────────────────────────────────────────────┐
  48.  │ #INCLUDE <DAVE&BIL.H>                    │
  49.  │ #INCLUDE <STDIO.H>                        │
  50.  │                                │
  51.  │ VOID MAIN(VOID)                        │
  52.  │ {                                │
  53.  │                                │
  54.  │ // This is a test program that plays a sound then stops  │
  55.  │                                │
  56.  │ high();           /* Plays my sound */            │
  57.  │ delay(1000);        /* pauses one second */            │
  58.  │ puts(" All done !"); /* displays our message */        │
  59.  │ exit();        /* then leave        */        │
  60.  │                                │
  61.  │ }                                │
  62.  └──────────────────────────────────────────────────────────┘
  63.  
  64.  
  65.    then compile it with:  TCC -MS TEST.C SFXLIB.LIB
  66.  
  67.  
  68.    (including SFXLIB.LIB in the command tells the compiler to
  69.     find our function--> high(); inside SFXLIB.LIB library. )
  70.  
  71.  
  72.     The file DAVE&BIL.H contains our function declaration, telling
  73.     the compiler that there's a function called high(); that is
  74.     NOT included in our source program.
  75.  
  76.     Then, the compiler finds that function in SFXLIB.LIB when it
  77.     starts compiling the program.
  78.  
  79.     That's how it works.
  80.  
  81.  
  82.  
  83. =========================================================================
  84.  
  85.     FUNCTIONS YOUR CAN USE:
  86.  
  87.     (be sure and DO NOT capitalize the function names.    I designed
  88.      them to be lowercase for ease of typing. )
  89.  
  90.  
  91.     arcade1();
  92.  
  93.     arcade2();         ┌───────────────────────────────────┐
  94.              │All 17 sounds have unique qualities│
  95.     bees();         │and effects of their own.  Try each│
  96.              │one out in the SFXDEMO.EXE program │
  97.     deadbird();      │to determine the sound they create.│
  98.              └───────────────┬───────────────────┘
  99.     downup();                 │
  100.                      │
  101.     echos();                 │
  102.                      │
  103.     fart();                 │
  104.                      │
  105.     fire();                 │
  106.             ────────────────┘
  107.     high();
  108.  
  109.     motors();
  110.  
  111.     pulse();
  112.  
  113.     ringing();
  114.  
  115.     siren();
  116.  
  117.     wars();
  118.  
  119.     bomb();
  120.  
  121.     bloop();
  122.  
  123.     beep();
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.           AND REMEMBER, THEY ARE FREEWARE !
  132.  
  133.      (but if you would like the complete version, including
  134.  
  135.       Sound FX for Windows, part 1, 2, 3, and 4
  136.  
  137.       Sound FX TSR
  138.  
  139.       and the newest, hottest version for DOS !
  140.  
  141.  
  142.           fill in the order form below....    )
  143.  
  144.  
  145.  
  146.  
  147. ===========================================================================
  148.  
  149.  
  150.     Sound Effects 5  Disk Order Form
  151.  
  152.     Name: ______________________________________________________
  153.  
  154.     Company: ___________________________________________________
  155.  
  156.     Address: ___________________________________________________
  157.  
  158.     City: ____________________________  State: _________________
  159.  
  160.     Zip code: _________________  Phone # : _____________________
  161.  
  162.     CompuServe # : _____________________________________________
  163.  
  164.     How did you acquire SFX ? __________________________________
  165.  
  166.     ____________________________________________________________
  167.  
  168.     What sound do you like best ?_______________________________
  169.  
  170.     ____________________________________________________________
  171.  
  172.     Registration                      $ 15.00
  173.  
  174.       (shipping is free inside U.S.)
  175.  
  176.     Shipping outside continental U.S.  ( $ 5.00 )      $________
  177.  
  178.  
  179.                          Total:   $________
  180.  
  181.     All Payments Must be in U.S. Dollars
  182.  
  183.     Make check or money order payable to:     David Smith
  184.                          1104 Mason Dr.
  185.                          Hurst TX 76053
  186.  
  187.  
  188.  
  189.     You can order directly from me or from Public (software) Library
  190.     with your MC, Visa, AmEx, or Discover card by calling 800-242-4PsL
  191.     (from overseas: 713-524-6394) or by FAX to 713-524-6398 or by
  192.     CompuServe to 71355,470.  These numbers are for ordering only.
  193.     I can NOT be reached at those numbers.    To contact me for information
  194.     about dealer pricing, volume discounts, site licensing, the status
  195.     of shipment of the product, the latest version number or for technical
  196.     information, write me at the above address.
  197.  
  198.  
  199.          ----------------end-of-author's-documentation---------------
  200.  
  201.                          Software Library Information:
  202.  
  203.                     This disk copy provided as a service of
  204.  
  205.                            Public (software) Library
  206.  
  207.          We are not the authors of this program, nor are we associated
  208.          with the author in any way other than as a distributor of the
  209.          program in accordance with the author's terms of distribution.
  210.  
  211.          Please direct shareware payments and specific questions about
  212.          this program to the author of the program, whose name appears
  213.          elsewhere in  this documentation. If you have trouble getting
  214.          in touch with the author,  we will do whatever we can to help
  215.          you with your questions. All programs have been tested and do
  216.          run.  To report problems,  please use the form that is in the
  217.          file PROBLEM.DOC on many of our disks or in other written for-
  218.          mat with screen printouts, if possible.  PsL cannot debug pro-
  219.          programs over the telephone, though we can answer questions.
  220.  
  221.          Disks in the PsL are updated  monthly,  so if you did not get
  222.          this disk directly from the PsL, you should be aware that the
  223.          files in this set may no longer be the current versions. Also,
  224.          if you got this disk from another vendor and are having prob-
  225.          lems,  be aware that  some files may have become corrupted or
  226.          lost by that vendor. Get a current, working disk from PsL.
  227.  
  228.          For a copy of the latest monthly software library newsletter
  229.          and a list of the 4,000+ disks in the library, call or write
  230.  
  231.                            Public (software) Library
  232.                                P.O.Box 35705 - F
  233.                             Houston, TX 77235-5705
  234.  
  235.                                 1-800-2424-PSL
  236.                              MC/Visa/AmEx/Discover
  237.  
  238.                           Outside of U.S. or in Texas
  239.                           or for general information,
  240.                               Call 1-713-524-6394
  241.  
  242.                           PsL also has an outstanding
  243.                           catalog for the Macintosh.
  244.  
  245.